发票回传请求 | 百度->商户

更新时间：2022-11-07

用户发票信息回传【百度即时请求商户】

接口描述

回传用户开发票信息

权限说明

为确保对内外请求安全性，添加公共参数并对公共参数进行统一验签，对于百度请求商户，百度在请求参数中添加以下公共参数，对于商户数据推送百度，在推送json数据体最外层key中也添加以下公共参数（详细见各推送数据样例）。

	字段名	类型	长度	必填	释义
1	tp_name	string	64	是	渠道号，开发前分配渠道号和私（primary_key），请妥善保管
2	timestamp	int	10	是	秒时间戳
3	salt	string	64	是	随机串
4	sign	string	64	是	签名，签名规则 md5(tp_name + timestamp + salt + primary_key)，单纯参数值（不含参数名）拼接，不需要加入参数名

请求参数

	字段名	类型	长度	必填	释义
1	bd_pre_order_id	string	64	是	百度预支付单号或合作方单号
2	post_type	int	-	是	发票领取方式：1：邮寄 2：电子发票
3	invoice_type	int	-	是	发票类型，1：增值税普通发票 2：增值税专用发票
4	comment	string	-	否	开票备注
5	invoice_title	string	-	是	发票抬头
6	invoice_price	int	-	是	开票金额单位：分
7	invoice_tax_type	int	-	是	抬头类型 1 公司 2 个人
8	company_tax	string	-	否	公司税号 (个人不需要)
9	receiver_name	string	64	否	收件人姓名（post_type为1时必填）
10	receiver_mobile	string	64	否	收件人手机号（post_type为1时必填）
11	receiver_address	string	128	否	邮寄地址（post_type为1时必填）
12	receiver_email	string	64	否	邮箱（post_type为2时必填）
13	company_tel	string	64	是	公司电话(invoice_type为2时必填)
14	register_address	string	256	是	公司注册地址(invoice_type为2时必填)
15	bank	string	256	是	开户行(invoice_type为2时必填)
16	bank_account	string	256	是	银行账号(invoice_type为2时必填)
17	公共参数	-	-	是	公共参数参考公共参数部分

receiver_email，receiver_name，receiver_mobile，receiver_address均进行加密，加密方式一致

响应参数

	字段名称	字段说明	字段要求	字段类型	长度
1	errno	错误码	0，success 21，重复开票 22，参数异常	string	-
2	msg	错误描述	0，success 21，重复开票 22，参数异常	string	-
3	data	详情信息		string	-

请求示例

GET {Host}/{Path}?bd_pre_order_id=xxxxxxx&post_type=2&invoice_type=1&invoice_title=1111&invoice_price=72695&invoice_tax_type=2&receiver_email=-4Mu0FyOovLn0WEnALUXZw&receiver_name=6-FDFQcJXFShvr5WMWqezQ&receiver_mobile=X5t1LJJuuzaZvkz1rn_Ag&tp_name=dl&timestamp=1649263159&salt=624dc23730690&sign=63af01152ffd50e3047b6fa8d29c9d2f

响应示例

正常
{"errno":0,"msg":"success","data":""}

错误
{"errno":21,"msg":"重复开票","data":""}

自营填单 | 百度->商户敏感信息加密规范